Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions for Getting and Playing Movies / Disabling Movies and Tracks

GetMovieActive

The GetMovieActive function allows your application to determine whether a movie is currently active. The Movie Toolbox services only active movies.

pascal Boolean GetMovieActive (Movie theMovie);

theMovie

Specifies the movie for this operation. Your application obtains this movie identifier from such functions as NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).

DESCRIPTION

The GetMovieActive function returns a Boolean value. The function sets this value to true if the movie is active and false if the movie is not active.

ERROR CODES

invalidMovie

-2010

This movie is corrupted or invalid

SEE ALSO

You can make a movie active by calling the SetMovieActive function, which is described in the previous section.